home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
IRIX Base Documentation 1998 November
/
IRIX 6.5.2 Base Documentation November 1998.img
/
usr
/
share
/
catman
/
p_man
/
cat3
/
Xm
/
XmeSecondarySource.z
/
XmeSecondarySource
Wrap
Text File
|
1998-10-30
|
10KB
|
133 lines
XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyySSSSoooouuuurrrrcccceeee((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyySSSSoooouuuurrrrcccceeee((((3333XXXX))))
NNNNAAAAMMMMEEEE
XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyySSSSoooouuuurrrrcccceeee - A toolkit function that takes ownership
of the secondary selection
SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
#include <Xm/TransferP.h>
BBBBoooooooolllleeeeaaaannnn XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyySSSSoooouuuurrrrcccceeee(
WWWWiiiiddddggggeeeetttt wwwwiiiiddddggggeeeetttt,
TTTTiiiimmmmeeee ttttiiiimmmmeeee);
VVVVEEEERRRRSSSSIIIIOOOONNNN
This page documents Motif 2.1.
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyySSSSoooouuuurrrrcccceeee takes ownership of the secondary
selection. A widget usually calls XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyySSSSoooouuuurrrrcccceeee from
an action routine that starts a secondary selection.
XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyySSSSoooouuuurrrrcccceeee establishes a function that is called
when the widget is asked to convert the secondary selection.
That function makes the following sequence of calls:
1. Calls the application's XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedures,
if any. XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyySSSSoooouuuurrrrcccceeee passes an
XXXXmmmmCCCCoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt(with the _s_e_l_e_c_t_i_o_n member set
to _S_E_C_O_N_D_A_R_Y) to each of these XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk
procedures.
2. Calls the source widget's ccccoooonnnnvvvveeeerrrrttttPPPPrrrroooocccc trait method;
ccccoooonnnnvvvveeeerrrrttttPPPPrrrroooocccc is one of the trait methods of the
_X_m_Q_T_t_r_a_n_s_f_e_rtrait. However, if any XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk
procedure returns XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTT____DDDDOOOONNNNEEEE or XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTT____RRRREEEEFFFFUUUUSSSSEEEE,
then XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyySSSSoooouuuurrrrcccceeee will not call ccccoooonnnnvvvveeeerrrrttttPPPPrrrroooocccc.
XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyySSSSoooouuuurrrrcccceeee also establishes a function that is
called when the widget loses the selection. That function
makes the following sequence of calls:
1. Calls the application's XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedures,
if any. XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyySSSSoooouuuurrrrcccceeee passes an
XXXXmmmmCCCCoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuuccccttttto each of these
XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedures. XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyySSSSoooouuuurrrrcccceeee
initializes the XXXXmmmmCCCCoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuuccccttttas follows:
+o Sets the _s_e_l_e_c_t_i_o_n member to _S_E_C_O_N_D_A_R_Y
+o Sets the _t_a_r_g_e_t member to ____MMMMOOOOTTTTIIIIFFFF____LLLLOOOOSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTTIIIIOOOONNNN
2. Calls the source widget's ccccoooonnnnvvvveeeerrrrttttPPPPrrrroooocccc trait method.
However, if any XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedure returns
XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTT____DDDDOOOONNNNEEEE or XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTT____RRRREEEEFFFFUUUUSSSSEEEE, then
XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyySSSSoooouuuurrrrcccceeee will not call ccccoooonnnnvvvveeeerrrrttttPPPPrrrroooocccc.
Page 1 (printed 10/24/98)
XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyySSSSoooouuuurrrrcccceeee((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyySSSSoooouuuurrrrcccceeee((((3333XXXX))))
XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyySSSSoooouuuurrrrcccceeee is used in conjunction with
XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyyTTTTrrrraaaannnnssssffffeeeerrrr.
_w_i_d_g_e_t Specifies the widget that is to take ownership of
the selection.
_t_i_m_e Specifies the time of the transfer. This is
usually the timestamp from the event passed to an
action routine. You should call
_X_t_L_a_s_t_T_i_m_e_S_t_a_m_p_P_r_o_c_e_s_s_e_d to generate the
_t_i_m_evalue. If you set _t_i_m_e to CCCCuuuurrrrrrrreeeennnnttttTTTTiiiimmmmeeee or 0,
UTM will automatically change the call to
_X_t_L_a_s_t_T_i_m_e_S_t_a_m_p_P_r_o_c_e_s_s_e_d.
RRRREEEETTTTUUUURRRRNNNN
This function returns False if the widget cannot take
ownership of the secondary selection. Otherwise, it returns
True.
RRRREEEELLLLAAAATTTTEEEEDDDD
XXXXmmmmQQQQTTTTttttrrrraaaannnnssssffffeeeerrrr(3), XXXXmmmmTTTTrrrraaaannnnssssffffeeeerrrrDDDDoooonnnneeee(3), XXXXmmmmTTTTrrrraaaannnnssssffffeeeerrrrVVVVaaaalllluuuueeee(3),
XXXXmmmmeeeeCCCClllliiiippppbbbbooooaaaarrrrddddSSSSiiiinnnnkkkk(3), XXXXmmmmeeeeCCCClllliiiippppbbbbooooaaaarrrrddddSSSSoooouuuurrrrcccceeee(3),
XXXXmmmmeeeeCCCCoooonnnnvvvveeeerrrrttttMMMMeeeerrrrggggeeee(3), XXXXmmmmeeeeDDDDrrrraaaaggggSSSSoooouuuurrrrcccceeee(3), XXXXmmmmeeeeDDDDrrrrooooppppSSSSiiiinnnnkkkk(3),
XXXXmmmmeeeeGGGGeeeettttEEEEnnnnccccooooddddiiiinnnnggggAAAAttttoooommmm(3), XXXXmmmmeeeePPPPrrrriiiimmmmaaaarrrryyyySSSSiiiinnnnkkkk(3),
XXXXmmmmeeeePPPPrrrriiiimmmmaaaarrrryyyySSSSoooouuuurrrrcccceeee(3), XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyySSSSiiiinnnnkkkk(3),
XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyyTTTTrrrraaaannnnssssffffeeeerrrr(3), XXXXmmmmeeeeSSSSttttaaaannnnddddaaaarrrrddddCCCCoooonnnnvvvveeeerrrrtttt(3),
XXXXmmmmeeeeSSSSttttaaaannnnddddaaaarrrrddddTTTTaaaarrrrggggeeeettttssss(3), and XXXXmmmmeeeeTTTTrrrraaaannnnssssffffeeeerrrrAAAAddddddddDDDDoooonnnneeeePPPPrrrroooocccc(3).
Page 2 (printed 10/24/98)